健康锻炼事件（HealthWorkoutEvent）# PRO

HealthWorkoutEvent 类用于访问 Apple 健康中记录的锻炼事件。每个事件表示一次锻炼过程中的特定动作或时刻，例如暂停、继续、圈数记录、标记、或自动运动检测。

#使用场景

• 分析锻炼流程：判断用户何时暂停或恢复锻炼。
• 统计锻炼中活跃与静止的时间段。
• 记录跑步、游泳等项目中的圈数。
• 用于可视化锻炼记录和事件时间轴。

#枚举：HealthWorkoutEventType

定义了各种类型的锻炼事件。

#类：HealthWorkoutEvent

#属性说明

说明：HealthDateInterval 是一个对象，包含：

• start: Date：事件开始时间
• end: Date：事件结束时间
• duration: number：事件持续时间（单位为秒）

#示例代码

#记录锻炼事件日志

function logWorkoutEvent(event: HealthWorkoutEvent) {
  const { type, dateInterval, metadata } = event
  const start = dateInterval.start.toISOString()
  const end = dateInterval.end.toISOString()
  const duration = dateInterval.duration

  console.log(`事件类型：${HealthWorkoutEventType[type]}`)
  console.log(`开始时间：${start}`)
  console.log(`结束时间：${end}`)
  console.log(`持续时长（秒）：${duration}`)

  if (metadata) {
    console.log(`元数据：${JSON.stringify(metadata)}`)
  }
}

#说明与提示

• HealthWorkoutEvent 实例通常包含在 HealthWorkout 中的 events 数组内。
• 可结合多个事件分析锻炼的完整时序、自动暂停/恢复、间歇训练分段等信息。
• 在无操作或锻炼设备脱离身体时，系统会自动生成 motionPaused / motionResumed 事件。